🎖️GitЯра🎖️ - /page/blob.mu

Micron Document

🎖️GitЯра🎖️

Node / meshtastic / Meshtastic-Android / files / docs / kmp-status.md

Displaying Rendered • View raw • Download

docs/kmp-status.md 91a61a36caa6f12d4829ea1daa6fb72ec57af95c (91a61a36) Text, 14.77 KB

KMP Migration Status

│ Last updated: 2026-04-15

Single source of truth for Kotlin Multiplatform migration progress. For the forward-looking roadmap, see roadmap.md. For completed decision records, see decisions/.

Summary

Meshtastic-Android has completed its Android-first structural KMP migration across core logic and feature modules, with full JVM cross-compilation validated in CI. The desktop target has a working Navigation 3 shell, TCP transport with full mesh handshake, and multiple features wired with real screens.

Modules that share JVM-specific code between Android and desktop now standardize on the T383838meshtastic.kmp.jvm.android convention plugin, which creates T383838jvmAndroidMain via Kotlin's hierarchy template API instead of manual T383838dependsOn(...) source-set wiring.

Module Inventory

Core Modules (21 total)

┌─────────────────┬──────┬─────────────┬───────────────────────────────────────────────────────────┐

│ Module │ KMP? │ JVM target? │ Notes │

├─────────────────┼──────┼─────────────┼───────────────────────────────────────────────────────────┤

│ T383838core:proto │ ✅ │ ✅ │ Protobuf definitions │

│ T383838core:common │ ✅ │ ✅ │ Utilities, T383838jvmAndroidMain source set │

│ T383838core:model │ ✅ │ ✅ │ Domain models, T383838jvmAndroidMain source set │

│ T383838core:repository │ ✅ │ ✅ │ Domain interfaces │

│ T383838core:di │ ✅ │ ✅ │ Dispatchers, qualifiers │

│ T383838core:navigation │ ✅ │ ✅ │ Shared Navigation 3 routes │

│ T383838core:resources │ ✅ │ ✅ │ Compose Multiplatform resources │

│ T383838core:datastore │ ✅ │ ✅ │ Multiplatform DataStore │

│ T383838core:database │ ✅ │ ✅ │ Room KMP │

│ T383838core:domain │ ✅ │ ✅ │ UseCases │

│ T383838core:prefs │ ✅ │ ✅ │ Preferences layer │

│ T383838core:network │ ✅ │ ✅ │ Ktor, T383838StreamFrameCodec, T383838TcpTransport, T383838SerialTransport, T383838B… │

│ T383838core:data │ ✅ │ ✅ │ Data orchestration │

│ T383838core:ble │ ✅ │ ✅ │ Kable multiplatform BLE abstractions in commonMain │

│ T383838core:nfc │ ✅ │ ✅ │ NFC contract in commonMain; hardware in androidMain │

│ T383838core:service │ ✅ │ ✅ │ Service layer; Android bindings in androidMain │

│ T383838core:ui │ ✅ │ ✅ │ Shared Compose UI, pure KMP QR generator, T383838jvmAndroidMain… │

│ T383838core:testing │ ✅ │ ✅ │ Shared test doubles, fakes, and utilities for T383838commonTest │

│ T383838core:takserver │ ✅ │ ✅ │ TAK/ATAK integration, Fountain codec │

│ T383838core:api │ ❌ │ — │ Android-only (AIDL). Intentional. │

│ T383838core:barcode │ ❌ │ — │ Android-only (CameraX). Flavor split minimised to decode… │

└─────────────────┴──────┴─────────────┴───────────────────────────────────────────────────────────┘

19/21 core modules are KMP with JVM targets. The 2 Android-only modules are intentionally platform-specific, with shared contracts already abstracted into T383838core:ui/commonMain.

Feature Modules (9 total — 9 KMP with JVM, 1 Android-only widget)

┌────────────────────────┬───────────────────┬─────────────────────────────────────────────────────┐

│ Module │ UI in commonMain? │ Desktop wired? │

├────────────────────────┼───────────────────┼─────────────────────────────────────────────────────┤

│ T383838feature:settings │ ✅ │ ✅ ~35 real screens; fully shared T383838settingsGraph an… │

│ T383838feature:node │ ✅ │ ✅ Adaptive list-detail; fully shared T383838nodesGraph, T383838… │

│ T383838feature:messaging │ ✅ │ ✅ Adaptive contacts + messages; fully shared T383838cont… │

│ T383838feature:connections │ ✅ │ ✅ Shared T383838ConnectionsScreen with dynamic transport… │

│ T383838feature:intro │ — │ — │

│ T383838feature:map │ — │ Placeholder; shared T383838NodeMapViewModel, T383838BaseMapViewM… │

│ T383838feature:firmware │ ✅ │ ✅ Fully KMP: Unified OTA, native Secure DFU, USB/… │

│ T383838feature:wifi-provision │ ✅ │ ✅ KMP WiFi provisioning via BLE (Nymea protocol);… │

│ T383838feature:widget │ ❌ │ — │

└────────────────────────┴───────────────────┴─────────────────────────────────────────────────────┘

Desktop Module

Working Compose Desktop application with:

• Navigation 3 shell (T383838NavigationRail + T383838NavDisplay) using shared routes

• Full Koin DI graph (stubs + real implementations)

• TCP, Serial/USB, and BLE transports with auto-reconnect and full T383838want_config handshake

• Adaptive list-detail screens for nodes and contacts

• Dynamic Connections screen with automatic discovery of platform-supported transports (TCP, Serial/USB, BLE)

• Desktop language picker backed by T383838UiPreferencesDataSource.locale, with immediate Compose Multiplatform resource updates

• Navigation-preserving locale switching via T383838Main.kt T383838staticCompositionLocalOf recomposition instead of recreating the Nav3 backstack

• Node detail metrics screens (Device, Environment, Signal, Power, Pax) wired with shared KMP + Vico charts

• Feature-driven Architecture: Desktop navigation completely relies on feature modules via T383838commonMain exported graphs (T383838settingsGraph, T383838nodesGraph, T383838contactsGraph, etc.), reducing the desktop module to a simple host shell.

• Native notifications and system tray icon wired via T383838DesktopNotificationManager

• Native release pipeline generating T383838.dmg (macOS), T383838.msi (Windows), and T383838.deb (Linux) installers in CI

Scorecard

┌────────────────────────────┬───────┬─────────────────────────────────────────────────────────────┐

│ Area │ Score │ Notes │

├────────────────────────────┼───────┼─────────────────────────────────────────────────────────────┤

│ Shared business/data logic │ 9/10 │ All core layers shared; RadioTransport interface unified │

│ Shared feature/UI logic │ 9/10 │ 9 KMP feature modules; firmware fully migrated; wifi-provi… │

│ Android decoupling │ 9/10 │ No known T383838java.* calls in T383838commonMain; app module extraction… │

│ Multi-target readiness │ 9/10 │ Full JVM; release-ready desktop; iOS simulator builds comp… │

│ CI confidence │ 9/10 │ 26 modules validated (including feature:wifi-provision); n… │

│ DI portability │ 8/10 │ Koin annotations in commonMain; supportedDeviceTypes injec… │

│ Test maturity │ 9/10 │ Mokkery, Turbine, and Kotest integrated; property-based te… │

└────────────────────────────┴───────┴─────────────────────────────────────────────────────────────┘

Completion Estimates

┌──────────────────────────────┬───────┐

│ Lens │ % │

├──────────────────────────────┼───────┤

│ Android-first structural KMP │ ~100% │

│ Shared business logic │ ~98% │

│ Shared feature/UI │ ~92% │

│ True multi-target readiness │ ~85% │

│ "Add iOS without surprises" │ ~100% │

└──────────────────────────────┴───────┘

Proposed Next Steps for KMP Migration

Based on the latest codebase investigation, the following steps are proposed to complete the multi-target and iOS-readiness migrations:

1. Wire Desktop Features: Complete desktop UI wiring for T383838feature:intro and implement a shared fallback for T383838feature:map (which is currently a placeholder on desktop).

2. Flesh out iOS Actuals: Complete the actual implementations for iOS UI stubs (e.g., T383838AboutLibrariesLoader, T383838rememberOpenMap, T383838SettingsMainScreen) that were recently added to unblock iOS compilation.

3. Boot iOS Target: Set up an initial skeleton Xcode project to start running the now-compiling T383838iosSimulatorArm64 / T383838iosArm64 binaries on a real simulator/device.

Key Architecture Decisions

┌────────────────────────────────────────────────────────────────────────────┬─────────┬───────────┐

│ Decision │ Status │ Details │

├────────────────────────────────────────────────────────────────────────────┼─────────┼───────────┤

│ Navigation 3 parity model (shared T383838TopLevelDestination + platform adapters) │ ✅ Done │ Both she… │

│ Hilt → Koin │ ✅ Done │ See de

• Agent guide: AGENTS.md

• Agent skills: .skills/

• Decision records: docs/decisions/

Served by rngit 1.5.4 - Generated in 0.12s